home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / byacc.1 < prev    next >
Text File  |  1995-07-25  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBYYYYAAAACCCCCCCC((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 11115555,,,, 1111999999990000))))          BBBBYYYYAAAACCCCCCCC((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           bYacc - an LALR(1) parser generator
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           bbbbyyyyaaaacccccccc [[[[ ----ddddllllrrrrttttvvvv ]]]] [[[[ ----bbbb _p_r_e_f_i_x ]]]] _f_i_l_e_n_a_m_e
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           bbbbyyyyaaaacccccccc reads the grammar specification in the file _f_i_l_e_n_a_m_e
  16.           and generates an LR(1) parser for it.  The parsers consist
  17.           of a set of LALR(1) parsing tables and a driver routine
  18.           written in the C programming language.  bbbbyyyyaaaacccccccc normally
  19.           writes the parse tables and the driver routine to the file
  20.           _y._t_a_b._c.
  21.  
  22.           The following options are available:
  23.  
  24.                ----bbbb _p_r_e_f_i_x
  25.                     The ----bbbb option changes the prefix prepended to the
  26.                     output file names to the string denoted by _p_r_e_f_i_x.
  27.                     The default prefix is the character _y.
  28.  
  29.                ----dddd   The ----dddd option causes the header file _y._t_a_b._h to be
  30.                     written.
  31.  
  32.                ----llll   If the ----llll option is not specified, bbbbyyyyaaaacccccccc will
  33.                     insert #line directives in the generated code.
  34.                     The #line directives let the C compiler relate
  35.                     errors in the generated code to the user's
  36.                     original code.  If the ----llll option is specified,
  37.                     bbbbyyyyaaaacccccccc will not insert the #line directives.  #line
  38.                     directives specified by the user will be retained.
  39.  
  40.                ----QQQQ[yyyy|nnnn]
  41.                     `-Qy' instructs bbbbyyyyaaaacccccccc to label the output file
  42.                     with the bbbbyyyyaaaacccccccc version, using an ####iiiiddddeeeennnntttt statement
  43.                     of the form
  44.  
  45.                     #ident "byacc: Berkeley Yacc (Cygnus)"
  46.  
  47.                     `-Qn' explicitly specifies that no such ####iiiiddddeeeennnntttt
  48.                     statement should be included; this is the default.
  49.  
  50.                ----rrrr   The ----rrrr option causes bbbbyyyyaaaacccccccc to produce separate
  51.                     files for code and tables.  The code file is named
  52.                     _y._c_o_d_e._c, and the tables file is named _y._t_a_b._c.
  53.  
  54.                ----tttt   The ----tttt option changes the preprocessor directives
  55.                     generated by bbbbyyyyaaaacccccccc so that debugging statements
  56.                     will be incorporated in the compiled code.
  57.  
  58.                ----VVVV   Display version information for bbbbyyyyaaaacccccccc on standard
  59.                     error.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/12/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBYYYYAAAACCCCCCCC((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 11115555,,,, 1111999999990000))))          BBBBYYYYAAAACCCCCCCC((((1111))))
  71.  
  72.  
  73.  
  74.                ----vvvv   The ----vvvv option causes a human-readable description
  75.                     of the generated parser to be written to the file
  76.                     _y._o_u_t_p_u_t.
  77.  
  78.           If the environment variable TMPDIR is set, the string
  79.           denoted by TMPDIR will be used as the name of the directory
  80.           where the temporary files are created.
  81.  
  82.      FFFFIIIILLLLEEEESSSS
  83.           _y._c_o_d_e._c
  84.           _y._t_a_b._c
  85.           _y._t_a_b._h
  86.           _y._o_u_t_p_u_t
  87.           /_t_m_p/_y_a_c_c._a_X_X_X_X_X_X
  88.           /_t_m_p/_y_a_c_c._t_X_X_X_X_X_X
  89.           /_t_m_p/_y_a_c_c._u_X_X_X_X_X_X
  90.  
  91.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  92.           If there are rules that are never reduced, the number of
  93.           such rules is reported on standard error.  If there are any
  94.           LALR(1) conflicts, the number of conflicts is reported on
  95.           standard error.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/12/95)
  130.  
  131.  
  132.  
  133.